home *** CD-ROM | disk | FTP | other *** search
/ PC World Interactive 4 / PC World Interactive 4.iso / share / multimed / wina16b.exe / FRONTEND.TXT < prev    next >
Text File  |  1997-11-06  |  4KB  |  131 lines
  1. This file is only useful for people who are writing frontends for Winamp.
  2. Actually, it's useful for plugin authors too.
  3.  
  4.  
  5.  
  6.  
  7. Psuedo IPC for frontends for Winamp v1.55+ (< 2.0)
  8. (v1.60 will have some extensions, listed at a later date)
  9.  
  10. This document is horribly [de]organized, and is pretty much just hacked
  11. together for people to use.
  12.  
  13. Winamp's window is found using:
  14. hwnd_winamp = FindWindow("Winamp v1.x",NULL);
  15.  
  16. #define WM_WA_IPC WM_USER
  17. // messages are sent to the winamp window using:
  18. result = SendMessage(hwnd_winamp,WM_WA_IPC,command_data,command);
  19.  
  20.  
  21. /* Messages available to send */
  22.  
  23. #define IPC_GETVERSION 0
  24. /*
  25.     IPC_GETVERSION is sent to the window, and the return value is the version
  26.         Version 1.55 = 0x1551
  27.         Version 1.6 BETA = 0x16A0
  28.     the command_data parameter is 0.
  29.     so, 
  30.     if (SendMessage(hwnd_winamp,WM_WA_IPC,0,IPC_GETVERSION) != 0x1551)
  31.         MessageBox(NULL,"Error, Winamp 1.55 not found","Warning",MB_OK);
  32. */
  33.  
  34.  
  35. #define IPC_PLAYFILE 100
  36. /*
  37.     IPC_PLAYFILE is sent to the window for each char of a null terminated string of a file to ADD
  38.     to the playlist (it doesn't change the playing status)
  39.     for example:
  40.         char *file = "C:\\download\\booga.mp3";
  41.         int x;
  42.         for (x = 0; x <= strlen(file); x ++)
  43.             PostMessage(hwnd_winamp,WM_WA_IPC,(LPARAM)file[x],IPC_PLAYFILE);
  44.     will add "C:\download\booga.mp3" to the end of the playlist
  45. */
  46.  
  47. #define IPC_DELETE 101
  48. /* 
  49.     IPC_DELETE deletes the internal Winamp playlist.
  50.         SendMessage(hwnd_winamp,WM_WA_IPC,0,IPC_DELETE);
  51. */
  52.  
  53. #define IPC_STARTPLAY 102
  54. /* 
  55.     IPC_STARTPLAY starts the playing.
  56.         SendMessage(hwnd_winamp,WM_WA_IPC,0,IPC_STARTPLAY);
  57. */
  58.  
  59. #define IPC_CHDIR 103
  60. /*
  61.     IPC_CHDIR is sent to the window for each char of a null terminated string of a directory to change to
  62.     for example:
  63.         char *dir = "C:\\Download";
  64.         int x;
  65.         for (x = 0; x <= strlen(file); x ++)
  66.             PostMessage(hwnd_winamp,WM_WA_IPC,(LPARAM)dir[x],IPC_PLAYFILE);
  67.     will change the winamp process to "C:\download" (useful for relative pathnames and loading playlists)
  68.  
  69. */
  70. #define IPC_ISPLAYING 104
  71. /*
  72.     IPC_ISPLAYING returns the status of playback.
  73.     If it returns 1, it is playing. if it returns 3, it is paused, if it returns 0, it is not playing.
  74.     If it returns something other than 1,3,or 0, something is screwed.
  75.     isplaying = SendMessage(hwnd_winamp,WM_WA_IPC,0,IPC_ISPLAYING);
  76. */
  77.  
  78.  
  79. #define IPC_GETOUTPUTTIME 105
  80. /*
  81.     IPC_GETOUTPUTTIME returns the position in milliseconds of the current song.
  82.     Returns -1 if not playing or error.
  83.     song_pos = SendMessage(hwnd_winamp,WM_WA_IPC,0,IPC_GETOUTPUTTIME);
  84. */
  85.  
  86.  
  87. // THESE MIGHT CHANGE in the future :)
  88. //Also, you can send standard WM_COMMAND messages to the Winamp window (for other controls), including
  89.  
  90. // toggles the EQ window
  91. #define WINAMP_OPTIONS_EQ               40036
  92. // toggles the playlist window
  93. #define WINAMP_OPTIONS_PLEDIT           40040
  94. // turns the volume up a little
  95. #define WINAMP_VOLUMEUP                 40058
  96. // turns the volume down a little
  97. #define WINAMP_VOLUMEDOWN               40059
  98. // fast forwards 5 seconds
  99. #define WINAMP_FFWD5S                   40060
  100. // rewinds 5 seconds
  101. #define WINAMP_REW5S                    40061
  102. // the following are the five main control buttons, with optionally shift or control pressed
  103. // (for the exact functions of each, just try it out)
  104. #define WINAMP_BUTTON1                  40044
  105. #define WINAMP_BUTTON2                  40045
  106. #define WINAMP_BUTTON3                  40046
  107. #define WINAMP_BUTTON4                  40047
  108. #define WINAMP_BUTTON5                  40048
  109. #define WINAMP_BUTTON1_SHIFT            40144
  110. #define WINAMP_BUTTON2_SHIFT            40145
  111. #define WINAMP_BUTTON3_SHIFT            40146
  112. #define WINAMP_BUTTON4_SHIFT            40147
  113. #define WINAMP_BUTTON5_SHIFT            40148
  114. #define WINAMP_BUTTON1_CTRL             40154
  115. #define WINAMP_BUTTON2_CTRL             40155
  116. #define WINAMP_BUTTON3_CTRL             40156
  117. #define WINAMP_BUTTON4_CTRL             40157
  118. #define WINAMP_BUTTON5_CTRL             40158
  119. // pops up the load file(s) box
  120. #define WINAMP_FILE_PLAY                40029
  121. // pops up the preferences
  122. #define WINAMP_OPTIONS_PREFS            40012
  123. // toggles always on top
  124. #define WINAMP_OPTIONS_AOT              40019
  125. // pops up the about box :)
  126. #define WINAMP_HELP_ABOUT               40041
  127.  
  128.  
  129. // hope this helps, 
  130. // -Justin [justin@spiffy.org]
  131.